home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_amanda.idb / usr / freeware / catman / a_man / cat8 / amplot.Z / amplot
Encoding:
Text File  |  1999-07-16  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      AAAAMMMMPPPPLLLLOOOOTTTT((((8888))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             AAAAMMMMPPPPLLLLOOOOTTTT((((8888))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       amplot - visualize the behavior of Amanda
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       aaaammmmppppllllooootttt [ ----cccc ]    [ ----eeee ] [ ----gggg ] [    ----llll ] [ ----pppp ] [ ----tttt _T ]
  13.       _a_m_d_u_m_p__f_i_l_e_s
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.       AAAAmmmmppppllllooootttt reads an aaaammmmdddduuuummmmpppp output    file that Amanda generates
  17.       each run (e.g.  _a_m_d_u_m_p._1) and    translates the information
  18.       into a picture format    that may be used to determine how your
  19.       installation is doing    and if any parameters need to be
  20.       changed.  AAAAmmmmppppllllooootttt also    prints out aaaammmmdddduuuummmmpppp lines    that it    either
  21.       does not understand or knows to be warning or    error lines
  22.       and a    summary    of the start, end and total time for each
  23.       backup image.
  24.  
  25.       AAAAmmmmppppllllooootttt is a shell script that    executes an aaaawwwwkkkk    program
  26.       (_a_m_p_l_o_t._a_w_k) to scan the aaaammmmdddduuuummmmpppp output file.    It then
  27.       executes a ggggnnnnuuuuppppllllooootttt program (_a_m_p_l_o_t._g)    to generate the    graph.
  28.       The aaaawwwwkkkk program is written in    an enhanced version of awk,
  29.       such as GNU awk (ggggaaaawwwwkkkk    version    2.15 or    later) or nnnnaaaawwwwkkkk.
  30.  
  31.       During execution, aaaammmmppppllllooootttt generates a few temporary files
  32.       that ggggnnnnuuuuppppllllooootttt uses.  These files are deleted at the end of
  33.       execution.
  34.  
  35.       See the _a_m_a_n_d_a(8) man    page for more details about Amanda.
  36.  
  37.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  38.       ----cccc   Compress    _a_m_d_u_m_p__f_i_l_e_s after plotting.
  39.  
  40.       ----eeee   Extend the X (time) axis    if needed.
  41.  
  42.       ----gggg   Direct _g_n_u_p_l_o_t output directly to the X11 display
  43.            (default).
  44.  
  45.       ----pppp   Direct postscript output    to file    _Y_Y_Y_Y_M_M_D_D....ppppssss (opposite
  46.            of ----gggg).
  47.  
  48.       ----llll   Generate    landscape oriented output.
  49.  
  50.       ----tttt _T Set the right edge of the plot to be _T hours.
  51.  
  52.       The _a_m_d_u_m_p__f_i_l_e_s may be in various compressed    formats
  53.       (ccccoooommmmpppprrrreeeessssssss, ggggzzzziiiipppp, ppppaaaacccctttt, ccccoooommmmppppaaaacccctttt).
  54.  
  55.      IIIINNNNTTTTEEEERRRRPPPPRRRREEEETTTTAAAATTTTIIIIOOOONNNN
  56.       The figure is    divided    into a number of regions.  There are
  57.       titles on the    top that show important    statistical
  58.       information about the    configuration and from this execution
  59.       of aaaammmmdddduuuummmmpppp.  In the figure, the X axis    is time, with 0    being
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 5/20/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      AAAAMMMMPPPPLLLLOOOOTTTT((((8888))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             AAAAMMMMPPPPLLLLOOOOTTTT((((8888))))
  71.  
  72.  
  73.  
  74.       the moment aaaammmmdddduuuummmmpppp was    started.  The Y    axis is    divided    into 5
  75.       regions:
  76.  
  77.            _Q_U_E_U_E_S: How many    backups    have not been started, how
  78.            many are    waiting    on space in the    holding    disk and how
  79.            many have been transferred successfully to tape.
  80.  
  81.            %_B_A_N_D_W_I_D_T_H: Percentage of allowed network bandwidth in
  82.            use.
  83.  
  84.            _H_O_L_D_I_N_G _D_I_S_K: The higher    line depicts space allocated
  85.            on the holding disk to backups in progress and
  86.            completed backups waiting to be written to tape.     The
  87.            lower line depicts the fraction of the holding disk
  88.            containing completed backups waiting to be written to
  89.            tape including the file currently being written to
  90.            tape.  The scale    is percentage of the holding disk.
  91.  
  92.            _T_A_P_E: Tape drive    usage.
  93.  
  94.            %_D_U_M_P_E_R_S: Percentage of active dumpers.
  95.  
  96.       The idle period at the left of the graph is time aaaammmmdddduuuummmmpppp is
  97.       asking the machines how much data they are going to dump.
  98.       This process can take    a while    if hosts are down or it    takes
  99.       them a long time to generate estimates.
  100.  
  101.      AAAAUUUUTTTTHHHHOOOORRRR
  102.       Olafur Gudmundsson ogud@tis.com
  103.       Trusted Information Systems
  104.       formerly at University of Maryland, College Park
  105.  
  106.      BBBBUUUUGGGGSSSS
  107.       Reports lines    it does    not recognize, mainly error cases but
  108.       some are legitimate lines the    program    needs to be taught
  109.       about.
  110.  
  111.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  112.       amanda(8), amdump(8),    gawk(1), nawk(1), awk(1), gnuplot(1),
  113.       sh(1), compress(1), gzip(1)
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 5/20/99)
  130.  
  131.  
  132.  
  133.